home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 2000 #2 / Sun Solutions CD (Volume 2 2000)(Special Focus - Java Technologies)(Disc 1).ISO / products / Software / BostonBusinessComputing / bbc / vbackup.cat < prev    next >
Text File  |  2000-02-11  |  45KB  |  991 lines
  1.  
  2.  
  3.  
  4. Vbackup(1)          Boston Business Computing           Vbackup(1)
  5.  
  6.  
  7.  
  8. NAME
  9.   Vbackup - perform backups, access DEC archives
  10.  
  11. SYNOPSIS
  12.   vvbbaacckkuupp --cc[11aaAAbbBBCCDDeeFFggiiIIKKLLmmMMnnNNPPRRssttTTuuvvVVwwyyYY] [--ff_d_e_v_i_c_e] _f_i_l_e_s
  13.   vvbbaacckkuupp --xx[11aaAACCDDeeFFjjMMnnooppQQRRssttTTuuUUvvVVwwyyYY] [--ff_d_e_v_i_c_e] [_f_i_l_e_s]
  14.   vvbbaacckkuupp --tt[11AAccDDeeFFMMnnRRssTTuuvvxx] [--ff_d_e_v_i_c_e] [_f_i_l_e_s]
  15.   vvbbaacckkuupp --MM[11ccDDIINNttTTuuxx] [--ff_d_e_v_i_c_e]
  16.   vvbbaacckkuupp --DD[11ccIIMMttTTuuxx] [--ff_d_e_v_i_c_e]
  17.   vvbbaacckkuupp --II[11BBccDDMMNN] [--ff_d_e_v_i_c_e]
  18.   vvbbaacckkuupp ----iinnffoo
  19.   vvbbaacckkuupp ----rreesseett [--ff_d_e_v_i_c_e]
  20.  
  21. DESCRIPTION
  22.   Vbackup has two main purposes:
  23.  
  24.     1. to make backups of online data; and
  25.  
  26.     2. to transfer data between VMS, RSTS, UNIX, and Windows systems.
  27.  
  28.   The intersection of these two purposes is the DEC BACKUP archive format.
  29.   This format was designed to resist data corruption due to media degrada-
  30.   tion, while making efficient use of media capacity and throughput.  It pro-
  31.   vides a high level of data safety, and is also commonly used in VMS and
  32.   RSTS archives.
  33.  
  34.   Vbackup reads and writes:
  35.  
  36.     o+  DEC BACKUP archives, also known as _s_a_v_e _s_e_t_s;
  37.  
  38.     o+  Files-11 archives, which can be created on VMS using the INITIALIZE,
  39.        MOUNT, and COPY utilities; and
  40.  
  41.     o+  Vbackup archives, which are save sets with DEC BACKUP-compatible
  42.        extensions to store UNIX- and Windows-specific information.
  43.  
  44.   Each command line may be specified using either of two syntaxes:
  45.  
  46.     o+  _t_a_r-_s_t_y_l_e, which is similar to that of UNIX ttaarr; and
  47.  
  48.     o+  _V_M_S-_s_t_y_l_e, which is similar to that of VMS BACKUP.
  49.  
  50.   This document deals primarily with tar-style syntax; see the printed manual
  51.   for information about VMS-style syntax.
  52.  
  53.   The eight command line forms in the synopsis correspond to the following
  54.   eight modes of operation:
  55.  
  56.   Save Mode
  57.        In save mode, Vbackup copies _f_i_l_e_s to an archive located at _d_e_v_i_c_e,
  58.        which is a tape device, CD-ROM device, or disk file.
  59.  
  60.  
  61.   Restore Mode
  62.        In restore mode, Vbackup extracts _f_i_l_e_s from an archive located at
  63.        _d_e_v_i_c_e, which is a tape device, CD-ROM device, or disk file.  If no
  64.        _f_i_l_e_s are specified, all files in the archive are extracted.
  65.  
  66.  
  67.   List Mode
  68.        In list mode, Vbackup lists information about _f_i_l_e_s in an archive
  69.        located at _d_e_v_i_c_e, which is a tape device, CD-ROM device, or disk
  70.        file.  If no _f_i_l_e_s are specified, all files in the archive are listed.
  71.  
  72.   Mount Mode
  73.        In mount mode, Vbackup emulates the VMS MOUNT command, verifying the
  74.        volume name of the tape or CD-ROM in _d_e_v_i_c_e and preparing for fast
  75.        access to it.  Vbackup automatically mounts devices as necessary, so
  76.        normally there is no need to specify this mode on the command line.
  77.  
  78.   Dismount Mode
  79.        In dismount mode, Vbackup emulates the VMS DISMOUNT command, making
  80.        _d_e_v_i_c_e available for other tapes or CD-ROMs or for access by other
  81.        programs.  If a device is mounted from a login shell, Vbackup arranges
  82.        for it to be automatically dismounted when that shell exits.  Other-
  83.        wise, it is necessary to run Vbackup in dismount mode to allow other
  84.        users or programs to use the device.
  85.  
  86.   Initialize Mode
  87.        In initialize mode, Vbackup emulates the VMS INITIALIZE command, dis-
  88.        carding all data on the tape in _d_e_v_i_c_e and electronically labeling it
  89.        with a new volume name and other information.  Vbackup automatically
  90.        initializes tapes as necessary, so normally there is no need to
  91.        specify this mode on the command line.
  92.  
  93.   Info Mode
  94.        In info mode, Vbackup displays information about itself.     Currently,
  95.        the displayed information consists of the names of the devices that
  96.        Vbackup will access if none are explicitly specified.
  97.  
  98.   Reset Mode
  99.        In reset mode, Vbackup arranges for the next access of tape or CD-ROM
  100.        _d_e_v_i_c_e to be unaffected by problems that occurred when Vbackup previ-
  101.        ously accessed it.
  102.  
  103. OPTIONS
  104.  
  105.   --11
  106.   ----ffiilleess--1111
  107.        Causes the --cc, --xx, --tt and --TT options to access tapes as Files-11
  108.        archives.  See _A_r_c_h_i_v_e _F_o_r_m_a_t in chapter 2 of the printed manual for
  109.        more information.
  110.  
  111.   --AA
  112.   ----nnooaassssiisstt
  113.        Prompts for confirmation before attempting to access a tape device
  114.        after failure of the previous attempt.  Normally, Vbackup periodically
  115.        tries to access a tape device until it succeeds or is interrupted.
  116.  
  117.   ----aacccceesssseedd
  118.        Causes the --YY and --yy options to compare against each file's access
  119.        date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  120.        information.
  121.  
  122.   --bb _s_i_z_e
  123.   ----bblloocckk--ssiizzee _s_i_z_e
  124.        Sets the save set's block size to _s_i_z_e bytes.
  125.  
  126.        Save set blocks are the units of data recovery: if media corruption
  127.        occurs, errors in one block per sequence of _g_r_o_u_p-_s_i_z_e blocks can be
  128.        corrected, where _g_r_o_u_p-_s_i_z_e is the value specified by the --gg option.
  129.  
  130.        A tape save set's block size is also the length of the physical tape
  131.        records used for storing the save set.
  132.  
  133.        Each block incurs a small, fixed amount of space overhead, and each
  134.        save set is padded to the nearest multiple of the block size.  There-
  135.        fore, the size of a save set may be decreased slightly by increasing
  136.        its block size if it contains a large amount of data and by decreasing
  137.        its block size otherwise.
  138.  
  139.        _s_i_z_e may range from 2048 to 65535, and defaults to 32256 for disk save
  140.        sets and 8192 for tape save sets.  Vbackup rounds _s_i_z_e up to the
  141.        nearest multiple of 512, and silently imposes a maximum of 65024 and
  142.        32256 respectively for tape and disk save sets.
  143.  
  144.        On a tar-style command line, _s_i_z_e may also range from 4 to 127, in
  145.        which case Vbackup multiplies _s_i_z_e by 512.
  146.  
  147.   ----bbaacckkuupp
  148.        Causes the --YY and --yy options to compare against each file's backup
  149.        date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  150.        information.
  151.  
  152.   ----bbrriieeff
  153.        Causes the --tt and --TT option to display the default, minimal amount of
  154.        detail about each file in the listed archives, canceling the effect on
  155.        the listing of any ----ffuullll option or --vv option that occurs earlier on
  156.        the command line.
  157.  
  158.   --cc
  159.   ----wwrriittee
  160.        Saves files to an archive.
  161.  
  162.        On VMS-style command lines, this option is normally implied by the
  163.        combination of a file or list of files as the first parameter and an
  164.        archive as the second.
  165.  
  166.        See _O_p_e_r_a_t_i_n_g _M_o_d_e_s in chapter 2 of the printed manual and _A_r_c_h_i_v_e
  167.        _L_o_c_a_t_i_o_n_s in chapter 2 of the printed manual for more information.
  168.  
  169.   --CC _d_i_r
  170.   ----ddiirreeccttoorryy _d_i_r
  171.        Sets the default directory to _d_i_r prior to saving or restoring files
  172.        that follow this option on the command line.  The option may be speci-
  173.        fied any number of times on a single command line.
  174.  
  175.        If a restore command line does not specify particular files to
  176.        restore, this option applies to all files restored.
  177.  
  178.        When saving, _d_i_r is relative to the directory specified in the previ-
  179.        ous instance of this option if there is one, and to the current direc-
  180.        tory otherwise.    When restoring, _d_i_r is always relative to the current
  181.        directory.
  182.  
  183.        This option overrides the target directory selection of the ----oouuttppuutt
  184.        option, normally specified as the second parameter of VMS-style
  185.        restore command lines.
  186.  
  187.   ----cchhaannggeedd
  188.        Causes the --YY and --yy options to compare against each file's change
  189.        date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  190.        information.
  191.  
  192.   ----ccoonnvveerrtt _k_e_y_w_o_r_d
  193.        Controls various aspects of the format in which Vbackup saves,
  194.        restores, and lists files.  The particular aspect controlled depends
  195.        on the value of _k_e_y_w_o_r_d, which may be one of the following:
  196.  
  197.        DDEELLIIMM
  198.      During restore, the non-negated and negated forms of this option
  199.      respectively insert and omit record terminators after each record of
  200.      every restored file.  Normally, Vbackup infers whether to insert or
  201.      omit record terminators from the record format and attributes of the
  202.      original file.     See _C_o_n_v_e_r_s_i_o_n _D_u_r_i_n_g _R_e_s_t_o_r_e in chapter 6 of the
  203.      printed manual for more information.
  204.  
  205.        EEOOFF--DDEELLIIMM
  206.      When restoring from a DEC BACKUP save set, if a file has STREAM,
  207.      STREAM_LF, or STREAM_CR record format and does not end with a record
  208.      terminator, Vbackup normally appends a record terminator to the
  209.      restored file.     The negative form of this option disables that
  210.      feature.
  211.  
  212.        FFOORRMMAATT==_f_m_t
  213.      Stores files in the record format specified by _f_m_t, which may be
  214.      FFIIXX, VVAARR, or IINNFFEERR.  See _C_o_n_v_e_r_s_i_o_n _D_u_r_i_n_g _S_a_v_e in chapter 6 of the
  215.      printed manual for more information.
  216.  
  217.        LLIISSTT==_s_y_s
  218.      When listing the contents of a save set, shows only information
  219.      meaningful on the system indicated by _s_y_s, which must be one of the
  220.      following:
  221.  
  222.      OORRIIGGIINNAALL   the system on which the save set was created
  223.  
  224.      LLOOCCAALL        the system on which the save set is being read
  225.  
  226.      UUNNIIXX        a UNIX system
  227.  
  228.      VVMMSS        an OpenVMS system
  229.  
  230.        SSCCAANN==_n
  231.      In conjunction with the ----ccoonnvveerrtt==ffoorrmmaatt==iinnffeerr option, scans the
  232.      first _n instead of the first 512 bytes of each file for non-
  233.      printable characters.    See _C_o_n_v_e_r_s_i_o_n _D_u_r_i_n_g _S_a_v_e in chapter 6 of
  234.      the printed manual for more information.
  235.  
  236.        SSIIZZEE==_n
  237.      When storing files in FIXED record format, uses a record length of _n
  238.      instead of the default 512 bytes.  See _C_o_n_v_e_r_s_i_o_n _D_u_r_i_n_g _S_a_v_e in
  239.      chapter 6 of the printed manual for more information.
  240.  
  241.        SSTTMM--NNUULLLLSS
  242.      When restoring a file with STREAM record format from a DEC BACKUP
  243.      save set, Vbackup normally deletes null characters at the beginning
  244.      of each record.  The negative form of this option disables that
  245.      feature.
  246.  
  247.   ----ccrreeaatteedd
  248.        Causes the --YY and --yy options to compare against each file's creation
  249.        date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  250.        information.
  251.  
  252.   --DD
  253.   ----ddiissmmoouunntt
  254.        Dismounts the tape or CD-ROM in the indicated device, making it avail-
  255.        able for different tapes or CD-ROMs or for access by other programs.
  256.  
  257.        If a device is mounted from a login shell, Vbackup arranges for it to
  258.        be automatically dismounted when that shell exits.  Otherwise, it is
  259.        necessary to run Vbackup with this option to allow other users or pro-
  260.        grams to use the device.
  261.  
  262.   ----ddeessccrriibbee _d_e_v_i_c_e
  263.        Specifies that ----mmeeddiiaa options that follow this option describe
  264.        default characteristics of archive location _d_e_v_i_c_e.
  265.  
  266.        ----mmeeddiiaa options following a --ff option override characteristics
  267.        described using this option.
  268.  
  269.        When crossing option source boundaries, values of this option accumu-
  270.        late rather than overriding each other.    See _C_r_o_s_s_i_n_g _O_p_t_i_o_n _B_o_u_n_-
  271.        _d_a_r_i_e_s in chapter 3 of the printed manual for more information.
  272.  
  273.        This option is typically used in configuration files.
  274.  
  275.        In a configuration file, indicates that tape device
  276.        //ddeevv//rrmmtt//ttppss00dd55nnrrnnssvv does not support software unload requests.
  277.  
  278.   --ee _f_i_l_e_s
  279.   ----eexxcclluuddee _f_i_l_e_s
  280.        Excludes files matching _f_i_l_e_s from being saved, restored, or listed.
  281.        _f_i_l_e_s may contain wildcards.
  282.  
  283.        When crossing option source boundaries, values of this option accumu-
  284.        late rather than overriding each other.    See _C_r_o_s_s_i_n_g _O_p_t_i_o_n _B_o_u_n_-
  285.        _d_a_r_i_e_s in chapter 3 of the printed manual for more information.
  286.  
  287.   ----eexxppiirreedd
  288.        Causes the --YY and --yy options to compare against each file's expiration
  289.        date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  290.        information.
  291.  
  292.   --FF
  293.   ----vvmmss--ddiissppllaayy
  294.        Uses VMS-style syntax when displaying file specifications in messages
  295.        and in archive listings.     Normally, Vbackup displays file specifica-
  296.        tions in UNIX-style syntax when started using a tar-style command
  297.        line, and in VMS-style syntax when started using a VMS-style command
  298.        line.
  299.  
  300.   --ff _d_e_v_i_c_e
  301.   ----ddeevviiccee _d_e_v_i_c_e
  302.        Accesses archives at the location specified by _d_e_v_i_c_e, which may be
  303.        the name of a tape or CD-ROM drive, the path of a disk file, or a
  304.        hyphen (--) to indicate a pipe.
  305.  
  306.        On VMS-style command lines, this option is normally specified as part
  307.        of the second parameter when saving and as part of the first parameter
  308.        when restoring or listing.
  309.  
  310.        If this option is not specified, the archive location defaults to the
  311.        system default tape device.
  312.  
  313.        See _A_r_c_h_i_v_e _L_o_c_a_t_i_o_n_s in chapter 2 of the printed manual and chapter
  314.        5, _T_a_p_e _a_n_d _C_D-_R_O_M _D_r_i_v_e_s in the printed manual for more information.
  315.  
  316.   ----ffuullll
  317.        Causes the --tt and --TT option to display more detail about each file in
  318.        the listed archives.  Depending on the listing format, the extra
  319.        detail may include file type, record format, permissions, creation
  320.        time, modification time, ownership, group membership, and other
  321.        characteristics.
  322.  
  323.   --gg _s_i_z_e
  324.   ----ggrroouupp--ssiizzee _s_i_z_e
  325.        When creating a save set, arranges for future errors in any one block
  326.        per sequence of _s_i_z_e data blocks to be correctable.  The error correc-
  327.        tion mechanism writes one extra non-data block per sequence of _s_i_z_e
  328.        data blocks unless _s_i_z_e is 0, in which case no extra blocks are writ-
  329.        ten and no errors are correctable.  _s_i_z_e may range from 0 to 100, and
  330.        defaults to 10.
  331.  
  332.   --HH
  333.   ----hheellpp
  334.        Displays a brief description of how to construct tar-style Vbackup
  335.        command lines.
  336.  
  337.   --ii
  338.   ----iinntteerrcchhaannggee
  339.        When creating a save set, sets the block size and group size to their
  340.        respective defaults of 8192 and 10.  This enhances save set portabil-
  341.        ity to non-VMS DEC systems.
  342.  
  343.   --II
  344.   ----iinniittiiaalliizzee
  345.        Discards all data on the indicated tape and electronically labels the
  346.        tape with a new volume name and other characteristics.  See _L_a_b_e_l_s in
  347.        chapter 6 of the printed manual for more information.
  348.  
  349.        Vbackup automatically initializes tapes as necessary, so normally
  350.        there is no need to specify this option.
  351.  
  352.   ----iiggnnoorree _k_e_y_w_o_r_d
  353.        Ignores information that normally could cause some special action.
  354.        The particular information ignored depends on the value of _k_e_y_w_o_r_d,
  355.        which may be one of the following:
  356.  
  357.        LLAABBEELL__PPRROOCCEESSSSIINNGG
  358.      Disables the normal volume name and expiration date checks when
  359.      writing to a tape.  See _L_a_b_e_l_s in chapter 6 of the printed manual
  360.      for more information.
  361.  
  362.        MMOODDIIFFIIEEDD__LLIINNKKSS
  363.      Ignores changes to files when determining whether two file names are
  364.      links to the same file.  Normally, Vbackup assumes two file names
  365.      are unrelated if the file they reference changes after encountering
  366.      one name but before encountering the other.
  367.  
  368.   ----iinnffoo
  369.        Displays the following information:
  370.  
  371.      o+
  372.      the devices that Vbackup will access if no devices are specified on
  373.      the command line;
  374.  
  375.      o+
  376.      the system default tape drive that Vbackup will access if no devices
  377.      are specified on the command line or in any configuration files.
  378.  
  379.   ----iinnppuutt _f_i_l_e
  380.        During a save operation, specifies the files that should be saved in
  381.        an archive.
  382.  
  383.        This option is normally specified as the first parameter on VMS-style
  384.        command lines and as all parameters on tar-style command lines,
  385.        although it may also be specified as a regular option on both types of
  386.        command line.
  387.  
  388.        See _S_p_e_c_i_f_y_i_n_g _F_i_l_e_s _T_o _S_a_v_e in chapter 4 of the printed manual for
  389.        more information.
  390.  
  391.   --jj _n
  392.   ----jjuunnkk _n
  393.        When restoring directory trees, discards the leading _n directory com-
  394.        ponents of each restored file's original path.
  395.  
  396.        If _n exceeds the number of directories in a file's original path, the
  397.        file is restored into the top level of the output directory.  A large
  398.        _n can therefore be used to restore files into a flat directory struc-
  399.        ture.
  400.  
  401.        This option overrides any original path modification effects of the --
  402.        --oouuttppuutt option, normally specified as the second parameter of VMS-
  403.        style restore command lines.
  404.  
  405.   --KK
  406.   ----ddeelleettee
  407.        During save, deletes each file immediately after it is saved.
  408.  
  409.   --LL
  410.   ----lliinnkk
  411.        When creating a save set, saves symbolic links as hard links, allowing
  412.        them to be restored as regular files on systems that do not support
  413.        symbolic links, such as VMS.  Normally, Vbackup saves symbolic links
  414.        as symbolic links, which are restored as zero-length files on systems
  415.        that do not support symbolic links.
  416.  
  417.        This option has no effect when creating an archive in Files-11 format,
  418.        which supports neither symbolic nor hard links.
  419.  
  420.   ----lloogg
  421.        When saving to or restoring from an archive, displays a log message
  422.        immediately after saving, restoring, or deleting each file.
  423.  
  424.   --mm
  425.   ----ccrroossss
  426.        During save, crosses NFS or other mount points while scanning direc-
  427.        tory trees.  Normally, Vbackup stays within the bounds of the file
  428.        systems containing the directory trees it searches.
  429.  
  430.   --MM
  431.   ----mmoouunntt
  432.        Mounts the tape or CD-ROM in the indicated device, verifying the
  433.        volume name of the media and preparing for fast access to it.
  434.  
  435.        Vbackup automatically mounts media as necessary, so normally there is
  436.        no need to specify this option.
  437.  
  438.   ----mmeeddiiaa _k_e_y_w_o_r_d
  439.        This option must follow a device specification.    It provides informa-
  440.        tion on how to access the device whose specification it follows.
  441.  
  442.        This option should generally not be used unless it is explicitly
  443.        recommended by Boston Business Computing technical support.  Normally,
  444.        Vbackup infers a suitable access mechanism for each device, making
  445.        this option unnecessary under most circumstances.  When it is neces-
  446.        sary, it is typically specified in configuration files to avoid exces-
  447.        sively long and cryptic command lines.
  448.  
  449.        The nature of the information provided by this option depends on the
  450.        value of _k_e_y_w_o_r_d, which may be one of the following:
  451.  
  452.        BBLLKKSSIIZZ==_n
  453.      If _n is zero, indicates that the device accepts variable-length
  454.      blocks; otherwise, specifies that the hardware-imposed tape block
  455.      size is _n bytes.
  456.  
  457.        DDEENNSSIITTYY==_n
  458.      Specifies that tapes contain _n bytes of data per inch.
  459.  
  460.        DDIISSAABBLLEE
  461.      Disables the device operations specified by _k_e_y_w_o_r_d, which may be
  462.      one of the following:
  463.  
  464.      DDIISSMMOOUUNNTT
  465.        Disables rewind, offline, and unload operations during dismount.
  466.        When reading a high-capacity tape containing a multi-volume save
  467.        set originally stored on several smaller-capacity tapes, this may
  468.        be useful for preventing the tape from rewinding at volume boun-
  469.        daries.
  470.  
  471.      OOFFFFLLIINNEE
  472.        Disables all offline operations.
  473.  
  474.      UUNNLLOOAADD
  475.        Disables all unload operations.  This may be necessary for media
  476.        changes to happen automatically when accessing a multi-volume
  477.        archive in a multi-tape loader.
  478.  
  479.        DDIISSKK
  480.      Indicates that the device is a disk rather than a tape.
  481.  
  482.        EEOOFFAA==_k_e_y_w_o_r_d
  483.      Upon detecting end-of-file, performs the action specified by _k_e_y_-
  484.      _w_o_r_d, which may be one of ffssff00, ffssff11, or nnoonnee.
  485.  
  486.        EEXXTTFFMMAARRKKSS
  487.      Indicates that the device uses extended file marks.
  488.  
  489.        FFMMAARRKKLLEENN==_n
  490.      Specified that tape file marks occupy the same amount of tape as _n
  491.      bytes of data.
  492.  
  493.        FFUUTTUURREE--AAPPPPEENNDD
  494.      If the device cannot overwrite file marks, writes one instead of two
  495.      file marks when closing a file on a tape to allow future appends to
  496.      that tape.
  497.  
  498.        IIRRGG==_n
  499.      Specifies that tape inter-record gaps occupy the same amount of tape
  500.      as _n bytes of data.
  501.  
  502.        LLEENNGGTTHH==_n
  503.      If the device does not support backspacing past and overwriting
  504.      records, avoids writing beyond the first _n meters of a tape.
  505.  
  506.        MMRREEWWRRIITTEE
  507.      Indicates that the tape can backspace past and overwrite file marks.
  508.  
  509.        NNOOUUNNLLOOAADD
  510.      Indicates that the device does not support software unload requests.
  511.  
  512.        OOFFLLAAGGSS==_f_l_a_g_s
  513.      Performs a bitwise inclusive OR of the tape open flags with _f_l_a_g_s
  514.      before opening each tape.
  515.  
  516.        RRMMTT--PPAATTHH==_p_a_t_h
  517.      If the device is on a remote system, starts the rrmmtt program on the
  518.      remote system by running _p_a_t_h instead of the default //eettcc//rrmmtt.
  519.  
  520.        RRRREEWWRRIITTEE
  521.      Indicates that the tape can backspace past and overwrite records.
  522.  
  523.        RRSSHH--PPAATTHH==_p_a_t_h
  524.      If the device is on a remote system, runs _p_a_t_h to open a channel to
  525.      the remote system.
  526.  
  527.        SSFFWWRRIITTEE
  528.      Indicates that the device cannot append to a tape after reading past
  529.      a file mark instead of skipping past it.
  530.  
  531.        TTAAPPEE
  532.      Indicates that the device is a tape rather than a disk.
  533.  
  534.        TTIIOO==_k_e_y_w_o_r_d
  535.      Accesses the device using the tape ioctl interface indicated by _k_e_y_-
  536.      _w_o_r_d, which may be one of mmttiioo, DDiiggiittaall, IIRRIIXX, LLiinnuuxx, AAIIXX, SSCCOO,
  537.      IInntteell, or AATTTT.
  538.  
  539.        As with any keyword, each _k_e_y_w_o_r_d may be negated by prepending NNOO to
  540.        it.
  541.  
  542.   ----mmooddiiffiieedd
  543.        Causes the --YY and --yy options to compare against each file's modifica-
  544.        tion date.  See _F_i_l_e _D_a_t_e_s in chapter 6 of the printed manual for more
  545.        information.
  546.  
  547.   --nn
  548.   ----nnooccrrcc
  549.        Inhibits CRC (Cyclic Redundancy Check) calculation and storage.
  550.  
  551.        Normally, Vbackup calculates and stores the CRC of each block in the
  552.        save set during save, and recalculates the CRC of each block to detect
  553.        and possibly correct corrupted data during restore.
  554.  
  555.        This option short-circuits that mechanism, making it impossible for
  556.        Vbackup to detect or correct media errors when reading save sets
  557.        created with this option.
  558.  
  559.        CRC calculation is computationally cheap, and CRC storage does not
  560.        affect archive size, so usually there is no reason to specify this
  561.        option.
  562.  
  563.   --NN _n_a_m_e
  564.   ----llaabbeell _n_a_m_e
  565.        When writing to the beginning of a tape, sets the tape's volume name
  566.        to the result of truncating _n_a_m_e to 6 characters, converting it to
  567.        uppercase, and replacing invalid characters in it with underscores
  568.        (__).  See _L_a_b_e_l_s in chapter 6 of the printed manual for more informa-
  569.        tion.
  570.  
  571.   --oo
  572.   ----bbyy--oowwnneerr
  573.        During restore, sets files to their original ownership and group
  574.        membership.  Normally, Vbackup sets file ownership and group member-
  575.        ship to those of the user performing the restore.  Users must have
  576.        appropriate system privileges to restore files to ownerships other
  577.        than their own.
  578.  
  579.   ----oouuttppuutt _d_i_r-_s_p_e_c
  580.        During a restore operation, specifies the directory into which files
  581.        should be restored, and under some circumstances causes leading direc-
  582.        tory components of restored files to be partially discarded.
  583.  
  584.        This option is normally specified as the second parameter on VMS-style
  585.        restore command lines, although it may also be specified as a regular
  586.        option on both VMS-style and tar-style command lines.
  587.  
  588.        The --CC and --jj options override the effects of this option.
  589.  
  590.        See _V_M_S-_s_t_y_l_e in chapter 4 of the printed manual for a full descrip-
  591.        tion of this option's semantics.
  592.  
  593.   --pp
  594.   ----rreeppllaaccee
  595.        During restore, silently overwrites existing files.  Normally, when a
  596.        file restoration would overwrite an existing file, Vbackup issues an
  597.        error message and skips that restoration.
  598.  
  599.   --PP _c_o_m_m_e_n_t
  600.   ----ccoommmmeenntt _c_o_m_m_e_n_t
  601.        When writing a save set, stores _c_o_m_m_e_n_t in such a way that subsequent
  602.        listings of the save set display the comment.  _c_o_m_m_e_n_t may not contain
  603.        more than 1024 characters.
  604.  
  605.   --QQ
  606.   ----rraaww
  607.        When restoring from a DEC BACKUP save set, disables the normal file
  608.        format translation mechanism so that restored files retain their low-
  609.        level RMS binary format.     See _D_a_t_a _C_o_n_v_e_r_s_i_o_n in chapter 6 of the
  610.        printed manual for more information.
  611.  
  612.   --RR
  613.   ----rreewwiinndd
  614.        When reading or writing a tape archive, rewinds the tape prior to
  615.        accessing it.  Normally, Vbackup starts at the current tape position
  616.        when reading and moves to the end of the data on a tape before writ-
  617.        ing.
  618.  
  619.        During a write operation, this option has the side effect of initial-
  620.        izing the tape with the volume name and expiration date indicated by
  621.        other options.  See _L_a_b_e_l_s in chapter 6 of the printed manual for more
  622.        information.
  623.  
  624.   ----rreesseett[==_k_e_y_w_o_r_d]
  625.        Unconditionally dismounts the indicated tapes or CD-ROMs if they are
  626.        mounted, and arranges for the next access to them to be unaffected by
  627.        problems that occurred when Vbackup previously accessed them.
  628.  
  629.        If _k_e_y_w_o_r_d is AALLLL, then this option affects all tape and CD-ROM dev-
  630.        ices currently being accessed by Vbackup; otherwise, it affects only
  631.        devices specified by the --ff option.
  632.  
  633.        This option should never be necessary unless there is a serious prob-
  634.        lem with the host system or with Vbackup.  If this option becomes
  635.        necessary, please contact Boston Business Computing technical support
  636.        for assistance.
  637.  
  638.   --ss _n_a_m_e
  639.   ----nnaammee _n_a_m_e
  640.        When writing a save set to a tape, sets the name of the save set to
  641.        _n_a_m_e.
  642.  
  643.        When reading one or more save sets from a tape, selects only save sets
  644.        whose names match _n_a_m_e, which may contain wildcards.
  645.  
  646.        Save set names may be up to seventeen characters long, and may contain
  647.        upper case letters, numbers, underscores (__), hyphens (--), dollar
  648.        signs ($$), and up to one dot (..).  Vbackup automatically modifies _n_a_m_e
  649.        as necessary to conform to these restrictions.
  650.  
  651.        On VMS-style command lines, this option is normally specified as the
  652.        file name portion of the device parameter.
  653.  
  654.   ----ssaavvee--sseett
  655.        Indicates that the preceding parameter specifies the location of a
  656.        save set.  Normally, this option is used only on VMS-style command
  657.        lines, but it may also be used on tar-style command lines.
  658.  
  659.   ----sseelleecctt _s_p_e_c
  660.        During a restore or list operation, specifies the files that should be
  661.        restored or listed.  If this option is absent, all files in the indi-
  662.        cated archives are restored or listed.
  663.  
  664.        On tar-style command lines, this option is normally specified as all
  665.        parameters.
  666.  
  667.        See _S_p_e_c_i_f_y_i_n_g _F_i_l_e_s _T_o _R_e_s_t_o_r_e in chapter 4 of the printed manual for
  668.        more information.
  669.  
  670.   ----sseettuupp _k_e_y_w_o_r_d
  671.        Allows customizing various aspects of Vbackup's operation.
  672.  
  673.        This option should generally not be used unless it is explicitly
  674.        recommended by Boston Business Computing technical support.  Normally,
  675.        Vbackup infers suitable defaults for optimal operation, making this
  676.        option unnecessary under most circumstances.  When it is necessary, it
  677.        is typically specified in configuration files to avoid excessively
  678.        long and cryptic command lines.
  679.  
  680.        The particular aspect of Vbackup's operation that this option affects
  681.        depends on the value of _k_e_y_w_o_r_d, which may be one of the following:
  682.  
  683.        AACCCCEESSSS
  684.      When performing an operation that results in mounting a tape or CD-
  685.      ROM, Vbackup normally only allows the user running Vbackup to access
  686.      the media while it is mounted.     This option allows access by the
  687.      user's group if _k_e_y_w_o_r_d is GGRROOUUPP and by everybody if _k_e_y_w_o_r_d is
  688.      WWOORRLLDD.
  689.  
  690.      Note that Vbackup cannot protect unmounted media against unauthor-
  691.      ized access: whenever a tape or CD-ROM is loaded in a device, it is
  692.      accessible by any user with sufficient system permission to access
  693.      the device.
  694.  
  695.        AANNSSIIDD--PPAATTHH==_p_a_t_h
  696.      Locates the aannssiidd program at _p_a_t_h.  The aannssiidd program is responsible
  697.      for maintaining mounted media state across multiple invocations of
  698.      Vbackup.  It is normally located in the Boston Business Computing
  699.      installation directory as file aannssiidd.
  700.  
  701.        DDIISSMMOOUUNNTT--TTIIMMEEOOUUTT==_t_i_m_e_o_u_t
  702.      On most systems, Vbackup automatically dismounts tapes mounted from
  703.      a login shell when the login shell exits.  Vbackup detects that a
  704.      login shell has exited by periodically waking up and checking for
  705.      the shell's existence.     This option overrides the default check
  706.      interval of 4 seconds.
  707.  
  708.        EEXXTTRRAA--CCOONNFFIIGG==_f_i_l_e
  709.      Reads a configuration file at path _f_i_l_e.  See _C_o_n_f_i_g_u_r_a_t_i_o_n _F_i_l_e_s in
  710.      chapter 3 of the printed manual for more information.
  711.  
  712.        LLOOAADD--CCOOMMMMAANNDD==_c_m_d
  713.      Runs shell command _c_m_d prior to mounting the second and subsequent
  714.      tapes of a multi-volume archive.  At the start of the command, shell
  715.      variables nnaamm, nnuumm, and ddeevv are respectively set to the volume name,
  716.      volume number, and device of the tape that will be mounted.  If the
  717.      command completes successfully, Vbackup immediately attempts to
  718.      mount the tape without requesting further confirmation.
  719.  
  720.  
  721.        MMOOUUNNTT--RREETTRRYY
  722.      If a media mount attempt fails for an unknown reason, causes Vbackup
  723.      to try again instead of exiting with an error message.
  724.  
  725.        QQMMEEMM==_n
  726.      Allocates _n instead of the default 1040384 bytes of shared memory
  727.      for the tape block queue.  If the queue is large enough and the host
  728.      system is fast enough, Vbackup is able to access tapes at top speed
  729.      regardless of factors such as CPU scheduling, disk access times, and
  730.      network latency.  Vbackup silently rounds _n up to the nearest multi-
  731.      ple of 512 not less than 325120.
  732.  
  733.        QQPPRROOFFIILLEE==_p_a_t_h
  734.      Writes queue profile data to file _p_a_t_h in a format suitable for
  735.      input into the ggnnuupplloott program.  The data can be helpful in select-
  736.      ing an optimal value for the ----sseettuupp==qqmmeemm option.  For more informa-
  737.      tion, please contact Boston Business Computing technical support.
  738.  
  739.        RREETTRRIIEESS==_n
  740.      When reading a save set, retries failed read operations _n instead of
  741.      the default 50 times before giving up and exiting.
  742.  
  743.        RRMMTT--PPAATTHH==_p_a_t_h
  744.      When accessing a device on a remote system, starts the rrmmtt program
  745.      on the remote system by running _p_a_t_h instead of the default
  746.      //eettcc//rrmmtt.  The ----mmeeddiiaa==rrmmtt--ppaatthh option overrides this option.
  747.  
  748.        RRSSHH--PPAATTHH==_p_a_t_h
  749.      When accessing a device on a remote system, runs _p_a_t_h to open a
  750.      channel to the remote system.    The ----mmeeddiiaa==rrsshh--ppaatthh option overrides
  751.      this option.
  752.  
  753.        RRUUNNDDIIRR==_d_i_r
  754.      Locates Vbackup device arbitration information in directory _d_i_r
  755.      instead of //ttmmpp//..bbbbcc//.     Because Vbackup locks files in this direc-
  756.      tory, this option may be necessary on systems whose //ttmmpp file sys-
  757.      tems do not support file locking.
  758.  
  759.        SSUUPPPPRREESSSS
  760.      Suppresses display of the message indicated by _k_e_y_w_o_r_d.  Currently,
  761.      the messages that can be suppressed are:
  762.  
  763.      FFIIXXRREECC      issued when Vbackup writes save set tape labels longer than
  764.           80 bytes
  765.  
  766.      NNOOAADDMM      issued when the auto-dismount mechanism is disabled
  767.  
  768.      NNOOEEOOVV      while writing a multi-volume tape archive, issued when
  769.           Vbackup completes a tape with no end-of-volume label set
  770.  
  771.        SSYYSSTTEEMM--CCOONNFFIIGG==_f_i_l_e
  772.      Locates the system configuration file at path _f_i_l_e.  See _C_o_n_f_i_g_u_r_a_-
  773.      _t_i_o_n _F_i_l_e_s in chapter 3 of the printed manual for more information.
  774.  
  775.        TTAAPPEEDD--PPAATTHH==_p_a_t_h
  776.      Locates the ttaappeedd program at _p_a_t_h.  The ttaappeedd program is responsible
  777.      for maximizing throughput between Vbackup and tape devices.  It is
  778.      normally located in the Boston Business Computing installation
  779.      directory as file ttaappeedd.
  780.  
  781.        UUSSEERR--CCOONNFFIIGG==_f_i_l_e
  782.      Locates the user configuration file at path _f_i_l_e.  See _C_o_n_f_i_g_u_r_a_t_i_o_n
  783.      _F_i_l_e_s in chapter 3 of the printed manual for more information.
  784.  
  785.   --tt
  786.   --TT _f_i_l_e
  787.   ----lliisstt[==_f_i_l_e]
  788.        Lists the files contained in one or more archives.  If _f_i_l_e is speci-
  789.        fied, the listing is written to that file; otherwise, it is written to
  790.        the standard output stream, which is typically the terminal from which
  791.        the Vbackup command was invoked.
  792.  
  793.        In a listing, the information about each file occupies a single line
  794.        unless the ----ffuullll option or the --vv option is specified, in which case
  795.        the information about each file occupies several lines.
  796.  
  797.        Normally, save set listings only show information meaningful on the
  798.        system on which the save set was created.  The ----ccoonnvveerrtt==lliisstt over-
  799.        rides this behavior.
  800.  
  801.   ----ttaappee--eexxppiirraattiioonn _d_a_t_e
  802.        When writing to the beginning of a tape, sets the tape's expiration
  803.        date to _d_a_t_e.  See _L_a_b_e_l_s in chapter 6 of the printed manual for more
  804.        information.
  805.  
  806.   --uu
  807.   ----uunnllooaadd
  808.        When performing any operation that involves dismounting a tape or CD-
  809.        ROM, prevents the tape or CD-ROM from being unloaded as part of the
  810.        dismount procedure.
  811.  
  812.        When performing any operation that involves mounting a tape or CD-ROM,
  813.        prevents the tape or CD-ROM from being unloaded as part of its even-
  814.        tual dismount procedure if this option is absent at that time.
  815.  
  816.        If this option is absent at both ends of a tape's or CD-ROM's mount-
  817.        dismount cycle, Vbackup unloads the tape or CD-ROM when dismounting
  818.        it.
  819.  
  820.   --UU
  821.   ----uuppppeerrccaassee
  822.        When restoring from a DEC BACKUP or Files-11 archive, disables conver-
  823.        sion of file names to lower case.  File names in DEC BACKUP and
  824.        Files-11 archives normally are in upper case, so this option normally
  825.        yields upper case file names.  See _F_i_l_e _N_a_m_e _C_o_n_v_e_r_s_i_o_n in chapter 4
  826.        of the printed manual for more information.
  827.  
  828.   --vv
  829.   ----vveerrbboossee
  830.        Activates the ----lloogg and ----ffuullll options, causing log messages to be
  831.        displayed when saving or restoring and more details to be displayed
  832.        when listing.
  833.  
  834.   --VV
  835.   ----vveerrssiioonn
  836.        During save, interprets a dot (..) followed by digits at the end of a
  837.        file name as a VMS version number.  During restore, appends each
  838.        file's VMS version number and a preceding dot to its restored file
  839.        name.
  840.  
  841.   --ww
  842.   ----ccoonnffiirrmm
  843.        Interactively prompts for confirmation before saving or restoring each
  844.        file.  Responses to the prompt are case-insensitive and may be abbre-
  845.        viated to a single letter.  Vbackup recognizes the following
  846.        responses:
  847.  
  848.        YYEESS, TTRRUUEE, or 11
  849.      Perform the current action.
  850.  
  851.        NNOO, FFAALLSSEE, 00, or EENNTTEERR
  852.      Do not perform the current action.
  853.  
  854.        AALLLL
  855.      Perform the current and all subsequent actions.
  856.  
  857.        QQUUIITT
  858.      Do not perform the current or any subsequent action.
  859.  
  860.   --xx
  861.   ----rreessttoorree
  862.        Restores files from one or more archives.
  863.  
  864.        On VMS-style command lines, this option is normally implied by the
  865.        combination of an archive as the first parameter and a directory as
  866.        the second.
  867.  
  868.        See _O_p_e_r_a_t_i_n_g _M_o_d_e_s in chapter 2 of the printed manual and _A_r_c_h_i_v_e
  869.        _L_o_c_a_t_i_o_n_s in chapter 2 of the printed manual for more information.
  870.  
  871.   --yy _d_a_t_e
  872.   ----ssiinnccee _d_a_t_e
  873.        Selects only files whose dates follow _d_a_t_e, which must be in VMS abso-
  874.        lute time format, described in _D_a_t_e _S_p_e_c_i_f_i_c_a_t_i_o_n_s in chapter 6 of the
  875.        printed manual.
  876.  
  877.        By default, Vbackup compares _d_a_t_e against each file's modification
  878.        date except when extracting from a DEC BACKUP or Files-11 archive,
  879.        when it compares against each file's creation date.  See _F_i_l_e _D_a_t_e_s in
  880.        chapter 6 of the printed manual for more information.
  881.  
  882.   --YY _d_a_t_e
  883.   ----bbeeffoorree _d_a_t_e
  884.        Selects only files whose dates precede _d_a_t_e, which must be in VMS
  885.        absolute time format, described in _D_a_t_e _S_p_e_c_i_f_i_c_a_t_i_o_n_s in chapter 6 of
  886.        the printed manual.
  887.  
  888.        By default, Vbackup compares _d_a_t_e against each file's modification
  889.        date except when extracting from a DEC BACKUP or Files-11 archive,
  890.        when it compares against each file's creation date.  See _F_i_l_e _D_a_t_e_s in
  891.        chapter 6 of the printed manual for more information.
  892.  
  893. EXAMPLES
  894.  
  895.   Save Mode
  896.  
  897.  
  898.   vvbbaacckkuupp --ccvvff //ddeevv//nnrrmmtt00hh //ttmmpp//ddaattaa
  899.        Stores directory tree //ttmmpp//ddaattaa// into a save set on tape device
  900.        //ddeevv//nnrrmmtt00hh, displaying a log message after storing each file.
  901.  
  902.   vvbbaacckkuupp --ccTT rroooott..jjaann22000000 --RRff //ddeevv//rrmmtt//00nn --ssrroooott..jjaann22000000
  903.        Stores the root directory tree into save set RROOOOTT..JJAANN22000000 on tape dev-
  904.        ice //ddeevv//rrmmtt//00nn, rewinding the tape prior to writing and generating a
  905.        listing of the save set's contents in file rroooott..jjaann22000000.
  906.  
  907.   vvbbaacckkuupp --ccff mmaarrvviinn:://ddeevv//nnrrmmtt88 --ssssrrcc..ssaavv ''**..cc'' ''**..hh''
  908.        Stores files whose names end in ..cc or ..hh into save set SSRRCC..SSAAVV on tape
  909.        device //ddeevv//rrmmtt88 on host mmaarrvviinn.
  910.  
  911.   vvbbaacckkuupp --cc11RRvvff //ddeevv//nnrrmmtt00 --NNssiimm99 ''**..ssiimm''
  912.        Stores files whose names end in ..ssiimm into a Files-11 archive on tape
  913.        device //ddeevv//nnrrmmtt00, rewinding the tape prior to writing, setting the
  914.        tape's volume name to SSIIMM99, and displaying a log message after storing
  915.        each file.
  916.  
  917.   vvbbaacckkuupp --ccvvff ssttuu..ssaavv //hhoommee//ssttuu
  918.        Stores the directory tree rooted at //hhoommee//ssttuu// into disk save set
  919.        ssttuu..ssaavv, displaying a log message after saving each file.
  920.  
  921.   Restore Mode
  922.  
  923.  
  924.  
  925.   vvbbaacckkuupp --xxvvff //ddeevv//nnrrmmtt11
  926.        Restores all files from the next save set on tape device //ddeevv//nnrrmmtt11
  927.        into the current working directory, displaying a log message after
  928.        restoring each file.
  929.  
  930.   vvbbaacckkuupp --xxvvff //ddeevv//rrmmtt//ttppss00dd44nnrrnnssvv --sseettcc..ssaavv ppaasssswwdd ggrroouupp
  931.        Restores files ppaasssswwdd and ggrroouupp from save set EETTCC..SSAAVV on tape device
  932.        //ddeevv//rrmmtt//ttppss00dd44nnrrnnssvv into the current directory, displaying a log mes-
  933.        sage after restoring each file.
  934.  
  935.   vvbbaacckkuupp --xxvvff //ddeevv//rrmmtt//00nn --CC//ttmmpp
  936.        Restores all files from the next save set on tape device //ddeevv//nnrrmmtt11
  937.        into directory //ttmmpp//, displaying a log message after restoring each
  938.        file.
  939.  
  940.   vvbbaacckkuupp --xx11vvff //ddeevv//nnrrmmtt00 ''**..oouutt''
  941.        Restores all files whose names end in ..oouutt from the Files-11 archive
  942.        on tape device //ddeevv//nnrrmmtt00 into the current directory, displaying a log
  943.        message after restoring each file.
  944.  
  945.   vvbbaacckkuupp --xxvvff ddaattaa..ssaavv ''**..ddaatt''
  946.        Restores all files whose names end in ..ddaatt from disk save set ddaattaa..ssaavv
  947.        into the current directory, displaying a log message after restoring
  948.        each file.
  949.  
  950.   List Mode
  951.  
  952.  
  953.   vvbbaacckkuupp --ttff //ddeevv//rrmmtt//00nn
  954.        Lists the contents of the next save set on tape device //ddeevv//rrmmtt//00nn.
  955.  
  956.   vvbbaacckkuupp --ttff qquuiimmbbyy:://ddeevv//rrmmtt//11nn --ss''**..**''
  957.        Lists the contents of all save sets on tape device //ddeevv//rrmmtt//11nn on host
  958.        qquuiimmbbyy.
  959.  
  960.   vvbbaacckkuupp --tt11ff //ddeevv//rrmmtt00..11
  961.        Lists the contents of the Files-11 archive on tape device //ddeevv//rrmmtt00..11.
  962.        If the tape contained save sets, this example would list the names of
  963.        those save sets without listing their contents; see _L_i_s_t_i_n_g _S_a_v_e _S_e_t
  964.        _N_a_m_e_s in chapter 6 of the printed manual for more information.
  965.  
  966.   vvbbaacckkuupp --ttvvff ddaattaa..ssaavv
  967.        Lists full details about the contents of disk save set ddaattaa..ssaavv.
  968.  
  969. FILES
  970.   $$HHOOMMEE//..vvbbaacckkuupprrcc       Per-user configuration file
  971.   //uussrr//lliibb//bbbbcc//vvbbaacckkuupprrcc   System-wide configuration file
  972.  
  973. AUTHOR
  974.   Boston Business Computing, Ltd.
  975.   13 Branch Street
  976.   Methuen, MA  01844-1955
  977.   (978) 725-3222
  978.   info@bosbc.com
  979.   http://www.bosbc.com/
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.